package com.cg.service;

import com.cg.ai.guardrail.SafeInputGuardrail;
import dev.langchain4j.service.*;
import dev.langchain4j.service.guardrail.InputGuardrails;
import reactor.core.publisher.Flux;

import java.util.List;

/**
 * AI编程助手服务接口
 * 提供多种AI对话和分析功能
 */
@InputGuardrails({SafeInputGuardrail.class})
public interface AiCodeHelperService {

    /**
     * 基础聊天功能
     * @param userMessage 用户消息
     * @return AI回复
     */
    @SystemMessage(fromResource = "prompts/system-prompt.txt")
    String chat(String userMessage);

    /**
     * 生成学习报告
     * @param userMessage 用户消息
     * @return 结构化的学习报告
     */
    @SystemMessage(fromResource = "prompts/system-prompt.txt")
    Report chatForReport(String userMessage);

    /**
     * 学习报告数据结构
     * @param name 报告名称
     * @param suggestionList 建议列表
     */
    record Report(String name, List<String> suggestionList) {
    }

    /**
     * 带RAG检索增强的聊天
     * @param userMessage 用户消息
     * @return 包含结果的响应
     */
    @SystemMessage(fromResource = "prompts/system-prompt.txt")
    Result<String> chatWithRag(String userMessage);

    /**
     * 流式对话功能
     * @param memoryId 会话记忆ID
     * @param userMessage 用户消息
     * @return 流式响应
     */
    Flux<String> chatStream(@MemoryId int memoryId, @UserMessage String userMessage);
}

